home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / program / gemxx19.zoo / gem++19 / man / gemda.man < prev    next >
Text File  |  1993-05-04  |  2KB  |  61 lines
  1.                      GEM++ - C++ LIBRARIES FOR GEM/AES/VDI
  2.  
  3.  
  4.  
  5. NAME
  6.      GEMdeskaccessory - a GEM desk accessory
  7.  
  8. DESCRIPTION
  9.      This is the abstract base class from which a desk accessory
  10.      derives the interactive object - defining the Open() and Close()
  11.      methods for the desk accessory.
  12.  
  13.      NOTE: In order to use a GEMdeskaccessory, the application must use
  14.      a statically allocated heap and stack by including the floowing
  15.      declarations:
  16.  
  17.           char _stack_heap[8192];   // Some appropriate size
  18.           void *_heapbase = (void *)_stack_heap;
  19.           long _stksize = sizeof(_stack_heap);
  20.  
  21.      Also, a program may determine whether it is indeed an application
  22.      or a desk accessory by testing the follow global value:
  23.  
  24.           extern int _app;
  25.  
  26. CONSTRUCTORS
  27.      GEMdeskaccessory(const GEMapplication& appl,
  28.          GEMactivity& in,
  29.          const char* MenuItemName)
  30.        Create a desk accessory in the given application with the given
  31.        name in the accessory menu, that receives Open and Close events
  32.        from the given activity.
  33.  
  34. METHODS
  35.      virtual void Open()=0
  36.      virtual void Close()=0
  37.        The GEMactivity containing the GEMdeskaccessory will call these
  38.        when the menu item for the GEMdeskaccessory is clicked, or when
  39.        the GEMdeskaccessory must close itself (due to application change).
  40.        Note that since GEM "automatically" deletes accessory windows,
  41.        the accessory should merely call the BecomeDeleted() method of
  42.        any open windows.
  43.  
  44. BUGS
  45.      Bugs in GEM++ should be reported to warwick@cs.uq.oz.au
  46.  
  47. AUTHOR
  48.      Warwick Allison, 1993.
  49.      warwick@cs.uq.oz.au
  50.  
  51. COPYING
  52.      This functionality is part of the GEM++ library,
  53.      and is Copyright 1993 by Warwick W. Allison.
  54.  
  55.      GEM++ is free and protected under the GNU Library General Public
  56.      License.
  57.  
  58.      You are free to copy and modify these sources, provided you
  59.      acknowledge the origin by retaining this notice, and adhere to
  60.      the conditions described in the GNU LGPL.
  61.